Application settings

Below you find the application settings, (default) solution settings and (default) user settings that can be configured, as well as a list of placeholders. The 'default solution' settings will be used for every newly created solution (saved to JewelSuiteFile or DMS). These settings are then stored in the solution. The 'application settings' and 'user settings' are used every time the JewelSuite application is started.

Application configurations

The ApplicationConfigurations section of the configuration file contains those settings that are configurable in the JewelSuite.exe.config file, and are overridable by settings in sub-configurations. The following settings are part of these application settings:

<ApplicationConfigurations>
<ApplicationConfiguration key="FactoryUserSettings" value="./Configurations/FactoryUserSettings.xml" />
<ApplicationConfiguration key="LithologyDictionary" value="./Configurations/LithologyDictionary.xml" />
<ApplicationConfiguration key="PropertyDictionary" value="./Configurations/PropertyDictionary.xml" />
<ApplicationConfiguration key="ColorSetDictionary" value="./Configurations/ColorSetDictionary.xml" />
<ApplicationConfiguration key="PropertyCalculatorDictionary" value="./Configurations/PropertyCalculatorDictionary.xml" />
<ApplicationConfiguration key="UnitSystemDictionary" value="./Configurations/UnitSystemDictionary.xml" />
<ApplicationConfiguration key="BlueMarbleGeoDataFile" value="" />
<ApplicationConfiguration key="DefaultDmsServers" value="dmsserverurl" />
<ApplicationConfiguration key="AllowCustomCrs" value="true" />
</ApplicationConfigurations>

*BlueMarbleGeoDataFile - The BlueMarble geodata.xml file installed with the application is used by default. To provide a custom data file usage, set the path to the BlueMarbleGeoDataFile setting.

**DefaultDmsServers - The entered value 'dmsserverurl' is the URL of the DMS server that the JewelSuite user will see listed in the drop-down list on the Connect to DMS form. It can be a comma separate list to include multiple DMS servers.

The above keys and values are (also) the default settings that apply when a key/value pair is not present or specified.

Solution settings

SolutionSettings contains the default settings for (new) JewelSuite solutions. These settings can be overridden by sub-configurations.

  • UserSettingsPath - The default path of the user settings is what is set to the Environment.SpecialFolder.UserProfile\AppData\Local\{ CompanyName}. If Environment.SpecialFolder.UserProfile is not setup on the machine, then the default path is set to the path where the executable is located. The default settings filename follows the following template: UserSettings.{applicationName}.{majorVersion}.{minorVersion}.json

    • For example: C:\Users\smitjoh\AppData\Local\Baker Hughes, the filename is UserSettings.JewelSuite.2026.1.json

  • CubicFeetOfGasForOneBarrelOfOilEquivalent with default value = 5800.464037 This value can be overwritten by modifying the value in the 'Gas to Boe conversion factor' field on the Constants form (home > Settings).

User settings

UserSettings, JewelSuiteSettings section, contains those settings that are user specific and which can be overridden by sub-configurations. It stores the settings that you can change in the home > Settings > Options button group.

  • UserDisplayName - This setting is used on various reports generated with the application. The default value is the username. With this setting you can change the default, for example instead of username ‘smitjoh' the name 'John Smith’ can be used. Note that this is a shared setting amongst all users using the same computer.
  • UserColorSetDictionaryFilePath - The default value is the path Environment.SpecialFolder.UserProfile\AppData\Local\{ CompanyName}\{CultureInfo.CurrentUICulture.Name }\ColorSetDictionary.xml when UserProfile available. Otherwise the path where the executable is located\{ CultureInfo.CurrentUICulture.Name }\ColorSetDictionary.xml.
  • MaxMostRecentUsedSolutions - This setting defines the amount of JewelSuiteFiles that the application remembers you have had open and saved in previous sessions.
  • CustomTempFolder - JewelSuite applications store temporary files used by the application while running. With this setting you can change the default path to the temporary files, which is pointing to the Temp directory in AppData. In order to use the custom temp folder you need to set the UseCustomTempFolder to true.
  • UseCustomTempFolder - This setting enables/disables the usage of the custom temp folder. True if the 'CustomTempFolder' setting is used, otherwise false.

In the AdditionalSettings section, the settings of add-ins are listed.

Placeholders

The following placeholders can be used in the Application settings (ApplicationConfigurations), User settings (DefaultUserConfigurations) and Solution settings (DefaultSolutionConfiguration). This means when you add one of these placeholders to the 'value' of a setting (also called configuration), the placeholder will be replaced, when JewelSuite starts, with the actual value.
Example: when you use %ApplicationShortName%, it will be replaced with the text 'JewelSuite' when you start JewelSuite.exe.
 
%ApplicationName%
%ApplicationShortName%
%SupportUrl%
%SupportEmailAddress%
%ProductName%
%ProductVersion%
%Copyright%
%ApplicationPath%
%CompanyName%
%BatchServerExecutableName%
%BatchServerInstallFolder%